home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / comm / ezadr221.zip / EASYADD.DOC < prev    next >
Text File  |  1996-01-19  |  16KB  |  323 lines
  1. ┌───────────────────────────────────────────────────────────────────────────┐ 
  2. │                  Copyright Notice and Program Disclaimer                  │ 
  3. └───────────────────────────────────────────────────────────────────────────┘
  4.  
  5.  This software is Copyright 1995 and owned by G.A.C. Computer Services.  
  6.  G.A.C. Computer Services grants to the user a nonexclusive license to use 
  7.  this software solely for its internal business purposes.  The user may not 
  8.  commercially distribute, sublicense, resell, or otherwise transfer for any 
  9.  consideration, or reproduce for any such purposes, the software or any 
  10.  modification or derivation thereof, either alone or in conjunction with any 
  11.  other product or program.  Further, the user may not modify the software or 
  12.  its support files for any purpose.
  13.  
  14.  
  15.  THIS SOFTWARE IS PROVIDED TO THE USER ''AS IS.''  G.A.C. COMPUTER SERVICES 
  16.  MAKES NO WARRANTIES, EITHER EXPRESS OR IMPLIED, WITH RESPECT TO THIS  
  17.  SOFTWARE AND/OR ASSOCIATED MATERIALS PROVIDED TO THE USER, INCLUDING 
  18.  BUT NOT LIMITED TO ANY WARRANTY OF MERCHANTABILITY, FITNESS FOR A 
  19.  PARTICULAR PURPOSE OR AGAINST INFRINGEMENT. G.A.C. COMPUTER SERVICES DOES 
  20.  NOT WARRANT THAT THE FUNCTIONS CONTAINED IN THE SOFTWARE WILL MEET YOUR 
  21.  REQUIREMENTS, OR THAT THE OPERATION OF THE SOFTWARE WILL BE 
  22.  UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE SOFTWARE WILL BE 
  23.  CORRECTED.  FURTHERMORE, G.A.C. COMPUTER SERVICES DOES NOT WARRANT OR MAKE 
  24.  ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE 
  25.  SOFTWARE OR ANY DOCUMENTATION PROVIDED HEREWITH IN TERMS OF THEIR 
  26.  CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE.  NO ORAL OR WRITTEN 
  27.  INFORMATION OR ADVICE GIVEN BY G.A.C. COMPUTER SERVICES OR A G.A.C. COMPUTER 
  28.  SERVICES AUTHORIZED REPRESENTATIVE SHALL CREATE A WARRANTY OR IN ANY WAY 
  29.  INCREASE THE SCOPE OF THIS WARRANTY.
  30.  
  31.  LIMITATION OF LIABILITY -- G.A.C. COMPUTER SERVICES AND ITS LICENSORS ARE 
  32.  NOT LIABLE FOR ANY CLAIMS OR DAMAGES WHATSOEVER, INCLUDING PROPERTY DAMAGE, 
  33.  PERSONAL INJURY, INTELLECTUAL PROPERTY INFRINGEMENT, LOSS OF PROFITS, OR 
  34.  INTERRUPTION OF BUSINESS, OR FOR ANY SPECIAL, CONSEQUENTIAL OR 
  35.  INCIDENTAL DAMAGES, HOWEVER CAUSED, WHETHER ARISING OUT OF BREACH OF 
  36.  WARRANTY, CONTRACT, TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR 
  37.  OTHERWISE.
  38.  
  39. ┌───────────────────────────────────────────────────────────────────────────┐ 
  40. │                  List of included files in the Archive                    │ 
  41. └───────────────────────────────────────────────────────────────────────────┘
  42.  
  43.     EASYADD.EXE  - The Main executable
  44.     EASYADD.DOC  - This Documentation file
  45.     ADDRESS.SAM  - Sample file of new address book addresses
  46.     EASYUP.EXE   - Program to Update V 1.0 USER files to V 2.0+ format
  47.     FILE_ID.DIZ  - A short description of Easy Address
  48.     REGISTER.DOC - A Registration form for G.A.C. Computer Services 
  49.             Products.
  50.     UPGRADE.DOC  - Step by Step Upgrade Instructions for SysOps        
  51.     HISTORY.DOC  - File explaining what has changed in Easy Address
  52.  
  53.     NOTE: EASYADD will make MANY small files when it executes.  
  54.  
  55.     EZ[#].ADD    - These files are created for each user in the Easy
  56.             Address directory
  57.     EASY[#].BIN  - These files are created in the SBBS\EXEC directory
  58.  
  59. ┌───────────────────────────────────────────────────────────────────────────┐ 
  60. │                      Description of Easy Address                          │ 
  61. └───────────────────────────────────────────────────────────────────────────┘
  62.  
  63.     NOTE: THIS PROGRAM SHOULD ONLY BE USED WITH SYNCHRONET 2.1 AND UP!
  64.  
  65.     This program is quite possibly one of the best utilities written for 
  66.     Synchronet.  It is an address book for use with Internet E-mail,
  67.     QWK Netmail, and/or Fidonet NetMail.  It should make the sysop's and 
  68.     users' experience with NetMail much easier and faster.  No longer do
  69.     you have to type in long or hard to remember e-mail addresses, rather
  70.     you and your users will store those addresses in your personal e-mail
  71.     address book.
  72.  
  73.     Easy Address was written with the Synchronet XSDK and Open Doors
  74.     programming libraries.  It has been tested and is in use all over
  75.     the world.  Easy Address is now easier to setup than ever before thanks
  76.     to a built-in configuration program, and it has all of the features that
  77.     SysOps expect to find in a well built program.
  78.  
  79.     Some of it's greatest features are: 
  80.     - an easy to use configuration program
  81.     - allows users to address e-mail messages with one keystroke
  82.     - Supports internet<->fidonet gateways (GUUCP) automatically with no
  83.       effort on the part of the user or SysOp.
  84.     - allows users to store hundreds of addresses with personalized 
  85.       notes about each address (if the he/she desires)
  86.     - allow SysOps to configure a file of default addresses that are 
  87.       loaded into the users address book the first time they use Easy 
  88.       Address.  
  89.     - allows SysOps to customize the colors used in the program
  90.  
  91.     As you can see Easy Address is an excellent addition to any Synchronet
  92.     BBS System.
  93.     
  94.  
  95.  
  96. ┌───────────────────────────────────────────────────────────────────────────┐ 
  97. │                     Installation of Easy Address                          │ 
  98. └───────────────────────────────────────────────────────────────────────────┘
  99.  
  100.     To set up Easy Address follow the instructions given below.  They include 
  101.     setting up Easy Address in the SCFG configuration program, and using the
  102.     CONFIG command line parameter to configure Easy Address.
  103.  
  104.     NOTE: - Easy Address requires BAJA.EXE to be in the EXEC directory.
  105.     
  106.     1. Create a directory for EASY ADDRESS
  107.         e.g. mkdir c:\sbbs\xtrn\easyadd <ENTER>
  108.  
  109.     2. Copy ALL of the archive files to this directory.
  110.         e.g. copy *.* c:\sbbs\xtrn\easyadd <ENTER>
  111.  
  112.     3. Use the CONFIG parameter to run the Easy Address configuration
  113.         e.g. EASYADD CONFIG <ENTER>
  114.  
  115.       Most options are self-explanatory, but the following need to be 
  116.       remembered when configuring Easy Address:
  117.  
  118.       - The internet option must be one of the following:
  119.         The FULL fidonet gateway (GUUCP) address that you use to send 
  120.           internet e-mail e.g. 1:13/10  If you do not know about 
  121.           GUUCP addresses, look in the archive GUUCP.ARJ for more
  122.           information.
  123.         SUUCP - if you are using NetXpress or a similiar software 
  124.           package to perform UUCP transfers.
  125.         NONE  - if you want to diable the internet e-mail option.
  126.  
  127.       - The timezone variable is needed so Easy Address can 
  128.         accurately display the current date and time to the user.  
  129.         This is the same variable used by TICK and many other 
  130.         bbs-related programs. It represents the difference in hours
  131.         between your location and Greenwhich Mean Time (GMT).  For 
  132.         the Eastern time zone,  it would be set to TZ=EST5EDT.  
  133.         Central Time Zone is TZ=CST6EDT, and Pacific is PST8EDT.  
  134.  
  135.       - The configuration options that allow you to specify what your
  136.         fidonet, internet or QWK e-mail addresses require that you 
  137.         ONLY specify the domain portion of the addresses, and NOT
  138.         include a user name.  Easy Address will display the users
  139.         name where appropriate.
  140.         e.g. I would just use 1:124/8047 for my fidonet address
  141.  
  142.     4. Go into SCFG->External Programs->External Programs and add two
  143.        external programs (EASYADD and EASYADDF, see example below) to 
  144.        your external program groups.  These will allow your users to
  145.        use the Easy Address book to send NetMail and File Attaches.
  146.     
  147.  
  148.     ╔[■][?]════════════════════════════════════════════════════╗
  149.     ║                          EASYADD                         ║
  150.     ╠══════════════════════════════════════════════════════════╣
  151.     ║ │Name                       Use Easy Address for NetMail ║
  152.     ║ │Internal Code              EASYADD                      ║
  153.     ║ │Start-up Directory         C:\SBBS\XTRN\EASYADD         ║
  154.     ║ │Command Line               EASYADD EMAIL                ║
  155.     ║ │Clean-up Command Line      *EASY%#                      ║
  156.     ║ │Cost in Credits            0                            ║
  157.     ║ │Extra Minutes              0                            ║
  158.     ║ │Suspended (Free) Time      No                           ║
  159.     ║ │Access Requirements                                     ║
  160.     ║ │Execution Requirements                                  ║
  161.     ║ │Multiple Concurrent Users  Yes                          ║
  162.     ║ │Intercept I/O Interrupts   Yes                          ║
  163.     ║ │Swap BBS out of Memory     Yes                          ║
  164.     ║ │Modify User Data           No                           ║
  165.     ║ │Execute on Event           No                           ║
  166.     ║ │BBS Drop File Type         Synchronet      XTRN.DAT     ║
  167.     ║ │Place Drop File In         Node Directory               ║
  168.     ╚══════════════════════════════════════════════════════════╝
  169.  
  170.                      AND
  171.  
  172.     ╔[■][?]════════════════════════════════════════════════════╗
  173.     ║                          EASYADDF                        ║
  174.     ╠══════════════════════════════════════════════════════════╣
  175.     ║ │Name                       Use Easy Address for Sending Files ║
  176.     ║ │Internal Code              EASYADDF                     ║
  177.     ║ │Start-up Directory         C:\SBBS\XTRN\EASYADD         ║
  178.     ║ │Command Line               EASYADD FILE                 ║
  179.     ║ │Clean-up Command Line      *EASY%#                      ║
  180.     ║ │Cost in Credits            0                            ║
  181.     ║ │Extra Minutes              0                            ║
  182.     ║ │Suspended (Free) Time      No                           ║
  183.     ║ │Access Requirements                                     ║
  184.     ║ │Execution Requirements                                  ║
  185.     ║ │Multiple Concurrent Users  Yes                          ║
  186.     ║ │Intercept I/O Interrupts   Yes->No to WWIV              ║
  187.     ║ │Swap BBS out of Memory     Yes                          ║
  188.     ║ │Modify User Data           No                           ║
  189.     ║ │Execute on Event           No                           ║
  190.     ║ │BBS Drop File Type         Synchronet      XTRN.DAT     ║
  191.     ║ │Place Drop File In         Node Directory               ║
  192.     ╚══════════════════════════════════════════════════════════╝
  193.  
  194. ┌───────────────────────────────────────────────────────────────────────────┐
  195. │    Optional Setup to Create a Custom List of Addresses for Your Users     │
  196. └───────────────────────────────────────────────────────────────────────────┘
  197.  
  198.     The file ADDRESS.SAM is included in the Easy Address archive.  This
  199.     file needs to be copied to ADDRESS.DAT to be used with Easy Address.
  200.     If the file ADDRESS.DAT does not exist, then users will be given two
  201.     default addresses for their address book, these addresses are my
  202.     Fidonet and Internet addresses.
  203.  
  204.     The file ADDRESS.DAT may contain as many addresses and notes about
  205.     the addresses as you want to include.  This is an excellent way for
  206.     you as SysOp to get your users familiar with NetMail.  The file must
  207.     follow a simple, but strict format, that is one line for the address
  208.     and the next line for the note about that address.  If this format
  209.     is not followed, your users will have a mixed up address book.
  210.  
  211.     e.g.
  212.         Gregory Campbel@1:124/8047              (1st line)
  213.         Author's Fidonet Address                (2nd Line)
  214.         campbel@onramp.net                      (3rd Line)
  215.         Author's Internet Address               (4th Line)
  216.         noname@company.net                      (5th Line)
  217.         None                                    (6th Line)
  218.  
  219.     As you can see above, if you do not want to enter a note about an
  220.     address, simply put the word None on that line (as in line 6).
  221.  
  222.     Save the file, and the next user that enter's Easy Address for the
  223.     FIRST time will receive your list of addresses.  
  224.  
  225. ┌───────────────────────────────────────────────────────────────────────────┐
  226. │     Optional Setup to Incorporate Easy Address into the NetMail Menu      │
  227. └───────────────────────────────────────────────────────────────────────────┘
  228.  
  229.     The way I prefer to run Easy Address on my system is to have it 
  230.     incorporated into my NetMail menu.  If you are familiar with the 
  231.     BAJA language, the following modifications will be simple, if you
  232.     are not, please read the BAJA.DOC file in your SBBS\DOCS directory
  233.     before attempting the following modifications (or at least back
  234.     up your currect .SRC files).
  235.     
  236.     1. Modify each of your BAJA source files (.SRC) as follows: 
  237.                 
  238.        e.g. Edit DEFAULT.SRC
  239.  
  240.         Replace the command MAIL_SEND_NETMAIL with:
  241.             EXEC_XTRN EASYADD
  242.         
  243.         and replace the command MAIL_SEND_NETFILE with:
  244.             EXEC_XTRN EASYADDF
  245.     
  246.     2. Compile the modified source files
  247.         e.g. BAJA DEFAULT.SRC <ENTER>
  248.  
  249.     3. Load up Synchronet SCFG and change the access requirements of
  250.        the EASYADD and EASYADDF external programs to LEVEL 99 and they
  251.        won't even show up to your users.  This way the intergration of
  252.        Easy Address is complete and invisible to the users.
  253.  
  254.  
  255. ┌───────────────────────────────────────────────────────────────────────────┐
  256. │  Optional Setup to Use the Internet<->Fidonet Gateway at 1:13/10 (GUUCP)  │
  257. └───────────────────────────────────────────────────────────────────────────┘
  258.  
  259.      GUUCP is a flag given to certain fidonet systems which designates them
  260.      as liasons between the internet and fidonet.  These systems allow
  261.      fidonet users to send e-mail to and receive e-mail from the internet.
  262.      To use the GUUCP gateway, you must first be running a fidonet compatible
  263.      system and be listed in the fidonet nodelist.  It is also important
  264.      that you understand the rules of the gateway.
  265.      
  266.      If you decide that you want to use Easy Address with this gateway to 
  267.      send and receive internet e-mail, you will have to register at the 
  268.      gateway.  You also need to note that all of your incoming internet 
  269.      e-mail will be placed on HOLD for you and you must poll the system
  270.      at 1:13/10 to pick up the e-mail at least twice a week, but the 
  271.      gateway use is free.  
  272.  
  273.      To setup Easy Address to use this gateway, do the following:
  274.     - File Request FAQ from 1:13/10 and read all the files.
  275.     - File Request REGISTER from 1:13/10 to register your system
  276.       with the gateway server.
  277.     - Setup your system to poll 1:13/10 twice a week (or more).
  278.     - Run EASYADD CONFIG
  279.         - Place 1:13/10 in the internet option (this is your 
  280.           full GUUCP address)
  281.         - Place your assigned internet domain address where
  282.           the config program asks.
  283.  
  284.      That's it, there is no need for your users to worry about how to 
  285.      address the internet messages, as long as they use valid internet 
  286.      addresses.  Easy Address will make sure the e-mail is sent through 
  287.      the gateway in the correct format.
  288.           
  289. ┌───────────────────────────────────────────────────────────────────────────┐
  290. │                    Registration and technical support                     │
  291. └───────────────────────────────────────────────────────────────────────────┘
  292.  
  293.     Registration cost is $20.00 U.S. for Easy Address
  294.     See the enclosed REGISTER.DOC file for instructions on how to 
  295.     register.
  296.  
  297.     For technical support, bug reports, comments AND suggestions please
  298.     contact me in one of the following ways:
  299.  
  300.      Send me NetMail:           Gregory Campbell@1:124/8047
  301.      Send me Internet E-mail:   campbel@onramp.net
  302.      World Wide Web:            http://rampages.onramp.net/~campbel/
  303.      Call my BBS:               214-527-6811 (login as Guest)
  304.      Call me voice:             214-517-3692 (10am-9pm CST, M-F)
  305.  
  306.     Or Ask me a question On Synchronet SysOps in DOVE-Net, my Alias 
  307.     is The.Tramp
  308.  
  309. ┌───────────────────────────────────────────────────────────────────────────┐
  310. │                              Acknowledgements                             │
  311. └───────────────────────────────────────────────────────────────────────────┘
  312.  
  313.     Special thanks go to all those people that helped with the alpha
  314.     and beta testing of this product.  Specifically the following people
  315.     need to be acknowledged:
  316.  
  317.     Rob Swindell - For creating Synchronet and the XSDK.
  318.  
  319.     Brian Pirie - For creating the Open Doors library of functions,
  320.         distributing and selling it as shareware.
  321.  
  322.  
  323.